home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / programr / hp48dev.zip / USERMAN.TX_ / USERMAN.TX
Text File  |  1995-07-09  |  18KB  |  447 lines
  1.  
  2.              User Manual
  3.              -----------
  4.  
  5.     HP48 User-RPL Program Development System
  6.     ----------------------------------------
  7.  
  8. Introduction:
  9. -------------
  10.  
  11. Welcome to the HP48 User-RPL Program Development System.  Using
  12. this program, you will be able to :
  13.  
  14. 1.  Write and edit your HP48 User-RPL variables for your programming
  15.     projects.  Using Windows' Multiple Document Interface, you can open
  16.     and edit multiple variable files all at once, using the cut and paste
  17.     utilities.  You can also search for a string, either from a variable, or
  18.     from all the variables in the opened project.
  19.  
  20. 2.  Design, display, and revise GROB objects (GRaphic OBjects).
  21.  
  22. 3.  Send and get HP variables from and to your HP48 via a friendly easy-
  23.     to-use Windows interface.
  24.  
  25. 4.  Manage your programming projects using the 'Project Manager'.  It
  26.     manage your projects by keeping the following information on your
  27.     project variables:
  28.  
  29.      -  When is the variable last edited.
  30.      -  When is the variable last sent to your HP48.
  31.      -  Is there a need to send it to your HP48.
  32.      -  Where is the source directory (PC), and the destination directory(HP)
  33.         of the variable.
  34.      -  Any comments you entered for the variable during its development.
  35.  
  36.     With a press of a mouse button, you can send all your variables in your
  37.     project to your HP48, or you can have the Project Manager update your
  38.     project to the HP48, automatically.
  39.  
  40. 5.  A PRINT function is available to output the project summaries, and
  41.     variables (codes and GROBs) to your printer for project documentation.
  42.  
  43.  
  44. Your HP48 User-RPL Programming Project:
  45. ---------------------------------------
  46. Your HP48 User-RPL programming project consists of a list of variables.
  47. The variables can be codes, or GROBs.  Each variable in your programming
  48. project has a source directory path (on the PC), and the destination
  49. directory path (on the HP) associate with it.  
  50.  
  51. This program contains the following tools:
  52.  
  53. 1.  Text Editor with Multiple Document Interface.
  54. 2.  GROB Editor.
  55. 3.  Send/Get Variable utilities.
  56. 4.  Program Manager.
  57.  
  58. Menu Sets:
  59. ---------
  60.  
  61. There are two sets of menus available in this program.   
  62.  
  63. The first set of menus offers functions to manage programming projects.  
  64. Functions include New Project, Open Project..., Save Project,  Add Variable..., 
  65. Remove Variable..., and Project Manager.   It is active when the program is
  66. first started, and when there is NO active Text Editor window opened.
  67.  
  68. The second set of menus offers functions for text editing.  Functions include
  69. New Variable, Open Variable..., Save, Save As..., editing functions, search
  70. function, and window attribute options.  It is active when there is at least one
  71. active Text Editor window opened.
  72.  
  73. Some functions are available in both sets of menus.  Functions include the
  74. GROB Editor functions New GROB, Open GROB..., Set Up... (for communication),
  75. Set Kermit Dir..., Send Variable..., and Get Variable...
  76.  
  77. Text Editor:
  78. ------------
  79. You use the text editor functions to write, edit, and save your variable codes 
  80. for your project.  
  81.  
  82. Major Menu Keys:
  83. ----------------
  84. - File | New Variable
  85.  
  86.   Select this menu to open up a new variable window where you can start
  87.   typing codes for a new variable.  A special header string for sending the 
  88.   variable to the HP is automatically insert at the top of the new file.
  89.  
  90. - File | Open Variable...
  91.  
  92.   Select this menu to select an existing HP variable in the file dialog window
  93.   for editing.
  94.  
  95. - File | Save   and  File | Save As...
  96.  
  97.   Select this menu to save your variable after you are done editing it.  
  98.   Note:  In order to get back to the first menu set, you must save or close all
  99.   your opened text editor window.   
  100.  
  101. - File | Edit | Cut  and  File | Edit | Copy  and File | Edit | Paste
  102.  
  103.   Select these menus to do cut and paste editing on the opened variable(s).
  104.   Before invoking these functions, highlight the selected text or click on 
  105.   a variable window for an insertion point first.  You may also use the short
  106.   cut toolbar button for these functions.
  107.  
  108. - File | Edit | Special Char 
  109.  
  110.   Select 'Begin Program' to insert the begin program  mode entry character \<<
  111.   at the insert point.
  112.  
  113.   Select 'End Program' to insert the end program mode entry character \>> at
  114.   the insert point.
  115.  
  116.   Select '\->' to insert the -> command character at the insert point.
  117.  
  118. - File | Search | Find ...
  119.  
  120.   Select Find... to search for a string in the current variable, or in all variables
  121.   in the currently opened project.  Select Find Next to search for the next 
  122.   occurence of the search string.  Searches are done only on code variables,
  123.   not GROB variables.  If the search string is found in a project variable which
  124.   is not opened, it will be opened in a text editor window with the search string
  125.   highlighted.
  126.  
  127. - Options
  128.  
  129.   Select Toolbar on or off to turn on or off the text editor short cut tool bar.  The
  130.   tool bar provides short cut for the New Variable, Open Variable..., Cut, Copy, 
  131.   and Paste functions.
  132.  
  133.   Select the BackColor, ForeColor, and Font menu keys for setting the background
  134.   color, foreground color, and the font for the current open text window.
  135.  
  136. GROB Editor:
  137. ------------
  138.  
  139. You use the GROB Editor to design and display GROB images for the HP48.  You
  140. click the left mouse button on the 131X64 pixel coordinate grid to 'paint' your image.
  141. Pixels on the grid may be turned on or off.  You pick up a region on the grid and 
  142. save the selected region of the grid as a GROB.  The program will automatically 
  143. generate the correct data for the GROB and save it as a variable.
  144.  
  145. To begin to run the GROB Editor with a blank grid, select Grob Editor | New Grob.
  146.  
  147. To begin to run the GROB Editor with a stored GROB, select
  148. Grob Editor | Open Grob...
  149.  
  150. Merge Mode:
  151. -----------
  152. Select GOR,  GXOR, or REPL(replace) mode for merging GROB images to the 
  153. existing grid image.  The default setting is the REPL mode.
  154.  
  155. Draw Mode:
  156. ----------
  157. Select Pixel ON  or Pixel Off to turn on or off the pixel drawing mode when you
  158. press the left mouse button.  The default setting is Pixel ON.
  159.  
  160. Pick Up:
  161. --------
  162. Click on the Pick Up icon to pick up a region on the grid for the functions 
  163. Save, Cut, and Copy.  After clicking the Pick Up magnet, press down the left 
  164. mouse button on the grid where the upper left corner of the region should start, 
  165. and drag the mouse pointer to where the lower right corner of the region, and 
  166. release.  A red dotted box should be displayed to indicate the picked up region.
  167.  
  168. Load Point:
  169. -----------
  170. Click on the Load Point icon and then click on the grid to select the loading pixel
  171. point for the next Open and Paste functions.  A purple-ish box outline is
  172. displayed on the selected pixel loading point.  The load point specifes the
  173. upper left corner of the grid where the image should be loaded, or merged.
  174.  
  175. New:
  176. ----
  177. Select New to erase the grid to start on a new drawing.
  178.  
  179. Pen Width:
  180. ----------
  181. Select Pen Width to toggle the pen width between 1 and  3 pixels.
  182.  
  183. Save:
  184. -----
  185. Select Save to save a picked up region of the grid as a GROB.
  186.  
  187. Open:
  188. -----
  189. Select Open to read in a GROB file and display it on the grid at the load point.
  190. If no load point is selected, the GROB is display at the upper left corner of the
  191. grid.  The Open command can be used to merge a GROB to the existing images
  192. on the grid, using the selected Merge Mode.
  193.  
  194.  
  195. Send/Get Variable Utilities:
  196. ----------------------------
  197.  
  198. The Comm menus provide utilities for file transfers between your PC and your
  199. HP48.  Use these menus to set up communication parameters and settings; to
  200. send a variable resides in a PC directory to the destination HP directory; to get
  201. a variable resides in an HP directory to the destination PC directory; and to set
  202. up the Kermit directory path in your PC.  
  203.  
  204. Note:  The file transfer features of this program require that the Kermit program 
  205. for MSDOS (available from Public Domain) is available in your PC.
  206.  
  207. Communication Set Up:
  208. ---------------------
  209. Select the Set Up... menu to set up the communication parameters between your
  210. PC and your HP48:
  211.  
  212. baud rate :  1200, 2400, 4800, or 9600.  Default setting is set at 9600.
  213. port:  COM1, or COM2.  Default setting is COM2.
  214. fraction mark:  comma(,), or period(.).  Default setting is period(.).
  215. parity:  none, odd, even, mark, or space.  Defautl setting is none.
  216. angle mode:  degrees, radians, or grads.  Default setting is degrees.
  217. translate code:  none, LF to CR-LF, 128-159, or 128-255.  Default setting is 128-255.
  218. Project variable transfer mode:  extension, or overwrite.  Default setting is overwrite.
  219.  
  220. Note: The Project variable transfer mode is active for transferring project variables
  221. in the Project Manager window only.
  222.  
  223. Set Kermit Directory:
  224. ---------------------
  225. Select Set Kermit Dir... to set the directory path where the Kermit program is 
  226. located on your hard disk.  This set up must be done before any file transfer
  227. may take place.  This program was tested using Kermit version 2.29. 
  228.  
  229. Note:  Once the Kermit directory is set, it is saved in a system file.  Repeat of this
  230. command is not necessary unless the directory location of your Kermit executable
  231. has changed.  
  232.  
  233. Send Variable:
  234. --------------
  235. Select Send Variable... to send a HP variable from your PC to your HP48.  For
  236. sending variables from a project, use the Project Manager (discuss later in this
  237. manual) instead.  The source directory (PC) and the name of the variable to be
  238. sent, as well as the destination directory (HP) must be first selected from the file 
  239. dialog controls.
  240.  
  241. Press 'HP Dir Format' to see what the format for HP directory path must be.
  242.  
  243. Server ON/OFF:
  244. --------------
  245. Select 'Keep SERVER on' if you want to have the server on after a file transfer.
  246. This is the default setting.
  247.  
  248. Select 'Turn SERVER off' if you want to have the server off after a file transfer.
  249.  
  250. Transfer Mode:
  251. --------------
  252. Select 'Extension' if you want to have the variable sent to the HP as a 'new' 
  253. variable with an extension tagged on to the name. Example: VAR.1
  254.  
  255. Select 'Overwrite' if you want to overwrite the existing (if there is one) variable
  256. with the new one sent.  This is the default setting.
  257.  
  258. Get Variable:
  259. -------------
  260.  
  261. Select Get Variable... to get a HP variable from your HP to your PC.  The source
  262. directory (HP) and the name of the variable to receive, as well as the destination
  263. directory (PC) must be first selected from the file dialog controls.
  264.  
  265. Please see the documentation for 'Send Variable' for information on Server ON/
  266. OFF Mode and Transfer Mode.
  267.  
  268. Note on data transfer:  You do not have to set the directory on your HP48 where
  269. the variable is or will be,  the program will set that for you.
  270.  
  271. Program Manager:
  272. ----------------
  273.  
  274. A project consists of a list of HP48 variables.  Variables may be codes or GROBs.
  275. Use the following menu selections for creating and managing your programming
  276. projects:
  277.  
  278. File | New Project:
  279. -------------------
  280.  
  281. Select this menu to start a new project.  The Project window will be displayed.
  282. The list box will be emptied indicating no variable has been added yet to the
  283. project.
  284.  
  285. File | Open Project:
  286. --------------------
  287.  
  288. Select this menu to open an existing project.  Name convention for project names
  289. is *.hpp.  Although this is not a mandatory requirement, but using this naming 
  290. convention will increase usability.  When a project is opened, the list box of the
  291. Project window will be filled with the names of all the variables in the project.
  292.  
  293. You may open a variable by double clicking its list box entry; or highlight its
  294. list box entry, and then press the 'Open Variable' command button.  The program
  295. will automatically open the text editor if the variable is a code variable; or the
  296. GROB editor if the variable is a GROB variable.
  297.  
  298. File | Save Project   and  File | Save Project As...:
  299. -----------------------------------------------------
  300.  
  301. Select this menu to save the currently opened project.  Saving project is required
  302. only if it has been changed.  A project is changed if a project variable is edited
  303. and save; if a GROB variable has been saved; and if the information from the Project
  304. Manager on the project has been changed.
  305.  
  306. The program will prompt you for saving project before existing or starting another
  307. project, if you do not explicitly save it yourself.  
  308.  
  309. To automatically have the program save the project everytime it is changed,
  310. select the Options | Auto Save Project On  option.
  311.  
  312. File | Add Variable...:
  313. -----------------------
  314.  
  315. Select this menu to add a variable to your currently opened project.  Use the
  316. file dialog controls to select the variable you want to add, then press the 'ADD'
  317. command button; or double clicking the highlighted variable entry in the file
  318. list box.  
  319.  
  320. Press 'OK' to cancel or end adding variables to your project.
  321.  
  322. File | Remove Variable...:
  323. --------------------------
  324.  
  325. Select this menu to remove a variable from your currently opened project. Its
  326. operation is similar to that of the 'Add Variable...' menu, except that it removes
  327. variables from your project.  The variables themselves are not deleted.
  328.  
  329. Window | Project Manger...:
  330. ---------------------------
  331.  
  332. Select this menu to display the Project Manger window.
  333. It shows a grid containing information about the variables in the currently opened
  334. project.  The fields of data are :
  335.  
  336.   - Variable Name
  337.   - Date/Time Last Edited
  338.   - Date/Time Last Downloaded
  339.   - Need To Download Status
  340.     A graphic and the word 'YES' is displayed if downloading is neccessary to the
  341.     HP to keep the project current.  Otherwise, the word 'NO' is displayed.  When a
  342.     variable is initially added to the project, the Need To Download Status is YES.
  343.   - HP Directory of the variable
  344.   - PC Directory of the variable
  345.   - Comment
  346.     A graphic is displayed if comments are entered for the variable.
  347.  
  348. Project Manager Grid Operations:
  349. --------------------------------
  350. You select a variable on the grid by clicking a name on the variable field, or any
  351. field for that variable.  One or more of the fields for that variable will be highlighted.
  352.  
  353. You may adjust the widths of any field by dragging the left mouse button to the left
  354. or to the right on the divider lines between fields at the top row of the grid.
  355.  
  356. If your project contains lot of variables, you may use the vertical scroll bar of the
  357. grid to access other hidden variables.
  358.  
  359. Project Manger Functions:
  360. -------------------------
  361.  
  362. The following command buttons in the Project Manager window are available 
  363. for managing your projects:
  364.  
  365. Send Project:
  366. -------------
  367. Press this button to send all variables in your project to the HP via Kermit.  All 
  368. variables are sent regardless of their Need To Download status.  Before a 
  369. variable is sent, its source directory (PC) path and its destination directory (HP)
  370. path must be entered.  Error messages will be displayed if they are not entered.
  371.  
  372. Send Variable:
  373. --------------
  374. Send a selected project variable to the HP via Kermit, regardless of its Need To
  375. Download status.  
  376.  
  377. Set HP Dir...:
  378. --------------
  379. Set up the HP directory path for the selected project variable.  To set all
  380. project variables to the same HP directory path, select the option 
  381. 'All' in the 'Apply To Var' option frame box before pressing the 'OK'
  382. button.
  383.  
  384. Update:
  385. -------
  386. Press this key for an automatic update of your programming project.  The program
  387. will send only those variables with the Need To Download status set to 'YES' to
  388. your HP48.
  389.  
  390. Comment...:
  391. -----------
  392. Enter or view any comments you may have on the selected project variable.  
  393. Information such as dates, functions, limitations, and version number may
  394. be entered for documentation.
  395.  
  396. Print...:
  397. ---------
  398. Press the 'Print...' command button to produce a hard copy of :
  399.  
  400. 1.  Project Manager -  A print out copy containing information on the currently
  401.      opened project.
  402. 2.  Variable codes - A print out copy of the code variables.
  403. 3.  GROBs - A graphic print out of the GROB variables.
  404.  
  405. When you select to print variable, you may print the current selected project
  406. variable by selecting 'Current', or all variables in the project by selecting
  407. 'All'.  You may also select 'Upper Left Corner' or 'Center' for printing graphical
  408. images for GROB variables.
  409.  
  410. About This Software...
  411. ----------------------
  412. This program is written in Visual Basic V3.00 By Stanley H. H. Lui.
  413. Thank you for using this software.
  414.  
  415. 7/1995
  416. Stan Lui
  417. ------------------------------------------------------------------------------
  418.             Copyright Notice
  419.             ----------------
  420.  
  421. This program is SHAREWARE.  You may freely use or distribute it provided
  422. that proper credit is given to the author.  You are running the un-registered
  423. version.  If you find that this program is useful, and you use it on a regular
  424. basis, you are encouraged to register.  The un-registered version of this
  425. program has most of the features of the registered version, but with the 
  426. following limitations:
  427.  
  428.      -  The number of file transfers are limited.
  429.      -  The Project Manger's UPDATE function is unavailable.
  430.      -  The PRINT function is unavailable.
  431.  
  432. If you decide to register, you will receive a 3 1/2" diskette containing the
  433. registered version.  With it, you also get two game program projects for
  434. your HP48:  The Game of Wari, and The Game of Hangman.  You will also
  435. be notified when there is a bug fix; or when a new version of the software 
  436. becomes available.
  437.  
  438. To register, send a personal check or money order for US $20.00 to
  439.  
  440.                   Stanley H. H. Lui
  441.                   5362 Armonk Court,
  442.                San Jose, CA  95123  USA
  443.  
  444. Please include your name and postal address when ordering.  
  445.  
  446.             Copyright 1995 Stanley H.H.Lui
  447.